home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / WINDOWS / PFM_231.ARJ / PFM.DOC < prev    next >
Text File  |  1992-06-06  |  44KB  |  1,009 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                    PFM INFORMATION MANUAL version 2.31
  8.  
  9.  
  10.  
  11.             Copyright Paul R. Culley & Henk de Heer  1983-1992
  12.                            All Rights Reserved
  13.  
  14.  
  15.  
  16.                         Release date:  06 JUN 1992
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. PFM Information Manual          Version 2.31                      Page  1
  65. C O N T E N T S
  66. -------------------------------------------------------------------------
  67.  
  68. WHAT IS PFM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  69. REQUIREMENTS FOR USE  . . . . . . . . . . . . . . . . . . . . . . . . . 3
  70. OPERATION OF PFM (MAIN MENU)  . . . . . . . . . . . . . . . . . . . . . 4
  71. MAIN MENU COMMANDS  . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  72. MAIN MEMU SPECIAL KEYS  . . . . . . . . . . . . . . . . . . . . . . . . 7
  73. MULTIFILE OPERATIONS  . . . . . . . . . . . . . . . . . . . . . . . . . 8
  74. MULTIFILE COMMANDS  . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  75. MORE MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  76. SORTING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  77. SHOW FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  78. SHOW FILE SPECIAL KEYS  . . . . . . . . . . . . . . . . . . . . . . .  11
  79. CONFIGURING . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  80. YOUR COMMANDS . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  81. DOS/YOUR COMMAND  . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  82. DESTINATION PATH INPUT  . . . . . . . . . . . . . . . . . . . . . . .  14
  83. LINE EDITING  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  84. ERRORS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127. PFM Information Manual          Version 2.31                      Page  2
  128. WHAT IS PFM
  129. -------------------------------------------------------------------------
  130.  
  131.         PFM is a personal file managment  system to help you to deal with
  132.         DOS. It is used to make common file maintenance chores easier and
  133.         faster. PFM is a "Front End" for the DOS command processor. It is
  134.         a  visual  directory  maintenance tool  with  pointer  and single
  135.         character menu  driven interface. It  is many  good things  which
  136.         users  have requested. To  find out  more, read the  rest of this
  137.         manual, or, (If  you are like me)  just start running it  and see
  138.         what it does.
  139.  
  140.  
  141. REQUIREMENTS FOR USE
  142. -------------------------------------------------------------------------
  143.  
  144.     *   MSDOS or PCDOS versions 2.0 or greater.
  145.     *   IBM pc's or compatible machines.
  146.     *   The  IBM monochrome  adapter, EGA,  or  color adapter  in  the 80
  147.         column text mode, or  an adapter that is  compatible with one  of
  148.         the above. (Note that PFM.COM produces flicker with the IBM color
  149.         adapter, Compaq and  other compatible's color adapters  work pro-
  150.         perly.)
  151.     *   50 kbytes of free memory (more is better!)
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190. PFM Information Manual          Version 2.31                      Page  3
  191. OPERATION OF PFM (MAIN MENU)
  192. -------------------------------------------------------------------------
  193.  
  194.         PFM can be started by typing  "PFM" on the DOS command line. Note
  195.         that if  you start PFM with a drive/path on the command line that
  196.         PFM will begin by displaying the indicated path.
  197.  
  198.         Example:        c:\pfm c:\util
  199.  
  200.         Starts PFM and display's the contents of the path  c:\util on the
  201.         menu screen.
  202.  
  203.         The main menu displayed by PFM consists of several sections.
  204.  
  205.         The  main section of the  screen in the  middle to the  left is a
  206.         listing of the directory at  the current drive/path. This listing
  207.         contains the file  names, sizes of  the files, date  and time  of
  208.         last  write, and  the attributes  of the  files. This  listing is
  209.         sorted in some order (the initial order is alphabetic with exten-
  210.         sions  given priority  over names).  You can  move the  cursor to
  211.         point to any  entry on this screen  with the cursor keys.  If you
  212.         get too  close  to the  beginning or  the end,  the display  will
  213.         scroll to  show you more files in the directory (as long as there
  214.         are some more).
  215.  
  216.         On  the top line  of the screen is  a list of  commands which are
  217.         available at the moment. These commands are activated by  hitting
  218.         the  highlighted  letter  from each  command  (usually  the first
  219.         letter) on  the keyboard.  If that  command works in  the current
  220.         situation, then it will do it's thing. If not, or  if the command
  221.         key  is not legal,  then nothing  will happen,  good or  bad (No,
  222.         bells, buzzes or error messages  here!). Many of the commands act
  223.         on the file that the cursor is next to (pointing to) allowing you
  224.         to do these commands on these files with only a few keystrokes.
  225.  
  226.         On the left side of the second line of the screen is the pathname
  227.         of the  current drive and  directory. On  the right  side is  the
  228.         volume label of the current disk. If  the disk has no label it is
  229.         displayed as [No Label ..].
  230.  
  231.         On the  left side  of the last  line of  the screen  is a  set of
  232.         commands which are  activated by hitting the  function keys (more
  233.         on this later).
  234.  
  235.         On the right side of the last line of the screen you see the most
  236.         commonly used direction key's, which will do the expected things.
  237.  
  238.         On  the right  side of  the  screen is  some  other miscellaneous
  239.         information about  the disk drive, directory, DOS  memory and the
  240.         date and time.
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253. PFM Information Manual          Version 2.31                      Page  4
  254. MAIN MENU COMMANDS
  255. -------------------------------------------------------------------------
  256.  
  257.         Following are  the  commands which  are activated  from the  main
  258.         menu. In general they will involve the file name that  the cursor
  259.         is pointing to  when the command is  hit. At this point  I should
  260.         note that if you start something  that you do not want to finish,
  261.         just hit the [ESC] key. This will get you back to the main menu.
  262.  
  263.         Many  of the commands require some kind  of typed in response. To
  264.         make this  easier, PFM  supplies an  initial input or  saves your
  265.         last input  to the response to save typing. To edit these respon-
  266.         ses see the section on 'LINE EDITING'.
  267.  
  268.     *   Attrib - Change  the file attributes of  the file. The attributes
  269.         of a  file are displayed in  the main part of the  screen as fol-
  270.         lows: "B"  not backed up,  "W" write protected,  "S" system type,
  271.         "H" hidden. PFM prompts you with a line as follows:
  272.  
  273.                         B= W= S= H=
  274.  
  275.         To add an attribute, change the "=" to a "+". To remove an attri-
  276.         bute  change the "=" to a  "-", or use the "=" to  leave it as it
  277.         is.
  278.  
  279.     *   Time - Change date  and time of the file.  The date and time  are
  280.         both displayed  on top  of the  screen. After modifying  just hit
  281.         enter to put on a file. Remember, seconds will added as a multip-
  282.         le  of two. If the file did not have the Backup attribute set, it
  283.         will be done by PFM.
  284.  
  285.     *   Copy -  Copy the pointed file  to somewhere. PFM will  prompt you
  286.         for a "destination". See the 'DESTINATION PATH INPUT' section for
  287.         the pathname and filename syntax.
  288.  
  289.         Note:   Since copying  a file to  itself would erase  most of the
  290.                 file, PFM considers  this an error and  does it's best to
  291.                 prevent this occurrence.
  292.  
  293.     *   Delete - Delete  a pointed file or directory. You must answer the
  294.         "Are you  sure" prompt with a "Y" to actually delete the file. If
  295.         a file is write protected  (a "W" in the attributes  column) then
  296.         an error  will occur. In this  case use the Attribute  command to
  297.         first unprotect the file. Note that DOS will not let you delete a
  298.         directory which contains files. PFM doesn't either.
  299.  
  300.     *   Edit - Edit the pointed file with your editor. PFM starts up your
  301.         editor on this file name. When you are done editing quit the edit
  302.         and  PFM will restart  right where it  left off  (Neat Huh?) Note
  303.         that Write-protected or  Hidden/System files may not  be editable
  304.         by your editor.
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316. PFM Information Manual          Version 2.31                      Page  5
  317.     *   Print -  Print the pointed file on system printer. The "lines per
  318.         page" prompt allows you to  specify a page length for files which
  319.         do not have form  feeds imbedded. If your file  is already paged,
  320.         specify  "0". If the file  has some form feeds,  then setting the
  321.         lines per page will insure that no page is longer than the speci-
  322.         fied  amount. If  you want more than  one copy of  the item being
  323.         printed, set the  number of copies  parameter to  the appropriate
  324.         number.  If you  want an  eight space  left  margin added  to the
  325.         printout,  answer 'Y'  to the  margin question.  PFM will  show a
  326.         "PRINTING" status  in the upper  left corner of  the screen until
  327.         printing is complete unless you  hit another key on the keyboard.
  328.         If you do, printing halts and you  are given a chance to abort or
  329.         continue the printout. (Hitting the  space key is the best way to
  330.         stop printing a file).
  331.  
  332.     *   Rename  - Change the name of the file or move file to a different
  333.         directory on  the same drive.  See the  'DESTINATION PATH  INPUT'
  334.         section for  the pathname  and filename  syntax. If applied  to a
  335.         directory, you can ONLY rename  the directory, you cannot move it
  336.         to a different place on the disk.
  337.  
  338.     *   Show - Displays the contents of the current file or directory  on
  339.         the  screen. If you  are showing a  directory, then you  are also
  340.         changing  to that  directory as  the current  directory.  See the
  341.         section on SHOW for more details on showing a file.
  342.  
  343.     *   cOmmand - Allows  the execution of DOS  commands. PFM prompts for
  344.         the text  of the  DOS command.  A blank entry  will activate  DOS
  345.         until the DOS  "EXIT" command is entered so that you can tempora-
  346.         rily use DOS  as you used to. See  the 'DOS/YOUR COMMAND' section
  347.         for commandline syntax and execution considerations.
  348.  
  349.     *   Your command - Like "O" command above, except uses your preconfi-
  350.         gured commands. See the  More Config command section  for details
  351.         on how to configure your own commands.
  352.  
  353.     *   Quit - Exit PFM and return to DOS. You will be prompted with "Are
  354.         you Sure".
  355.  
  356.     *   More - Allows operations not related to the  displayed directory.
  357.         Use to config PFM, edit a new file, make a new directory, or show
  358.         a pathname. See the 'MORE MENU' section for details.
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379. PFM Information Manual          Version 2.31                      Page  6
  380. MAIN MENU SPECIAL KEYS
  381. -------------------------------------------------------------------------
  382.  
  383.     *   F1 - help. This key doesn't need comment. Just hit it from almost
  384.         everywhere in PFM to  get detailed information about the  current
  385.         operation or screen. Includes some error help.
  386.     *   F5 -  reread dir.  This key  causes the  current directory to  be
  387.         reread to  update the screen.  This is  done automatically  after
  388.         each PFM command  unless files are marked (see  'MULTIFILE OPERA-
  389.         TIONS'). This can be used when a disk has been changed or you are
  390.         finished with any  marks on the screen. If files  are marked, you
  391.         will be prompted "Are You Sure".
  392.     *   F6 - sort. This key  allows you to re-sort the directory listing.
  393.         See the section on 'SORTING' for more details.
  394.     *   F7 - swap display. PFM has the ability to keep all the informati-
  395.         on  about  the  directory that  you  are  currently  viewing (the
  396.         primary display)  while showing  an entirely  different drive  or
  397.         directory (the secondary  display). I call the process  of saving
  398.         the current display and switching to the new "swapping displays".
  399.         When you  hit [F7]  the first  time, PFM  prompts you  for a  new
  400.         drive/path  to display. When this is done,  the third line of the
  401.         screen changes  to reverse vidio  to indicate that  you are using
  402.         the secondary  display. You  can do anything while  the secondary
  403.         display  is shown  that you  can do  normally.  To return  to the
  404.         primary display, hit [F7] again.  When switching back, the origi-
  405.         nal contents are  displayed unchanged. The last  several directo-
  406.         ries that you  referred to can be  accessed by the cursor  up and
  407.         down arrows.
  408.     *   F8 - in/exclude.  This key toggles the include flag on an indivi-
  409.         dual file. See the 'MULTIFILE' section for more information.
  410.     *   F10 - multi. This key  is used to switch between  single-file and
  411.         multi-file  mode. See the 'MULTIFILE' section for more informati-
  412.         on.
  413.  
  414.     *   Space  - in/exclude.  This key  toggles  the include  flag  on an
  415.         individual file.  Note  that  the last  file from  the  directory
  416.         listing can only done  once, if you want to correct  a mistake on
  417.         the last file you need to use [F8] or to hit any other key before
  418.         trying again with the space.
  419.     *   ESC - backup directory tree. This shows the "parent" directory of
  420.         the current directory  (the one closer to the  "root"). If you at
  421.         the "root", this just rereads the current directory.
  422.  
  423.     *   Home -          Moves to the top of the directory listing.
  424.     *   End -           Moves to the end of the directory listing.
  425.     *   Up arrow -      Moves up by one line.
  426.     *   Down arrow -    Moves down by one line.
  427.     *   Pg Up -         Moves upward by 20 lines.
  428.     *   Pg Dn -         Moves downward by 20 lines.
  429.     *   '+' -           Moves downward by 10 lines.
  430.     *   '-' -           Moves upward by 10 lines.
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442. PFM Information Manual          Version 2.31                      Page  7
  443. MULTIFILE OPERATIONS
  444. -------------------------------------------------------------------------
  445.  
  446.         PFM has the ability to do operations on more than one file at one
  447.         time. This I  call "multifile" operation. Multifile  operation is
  448.         useful for many operations.
  449.  
  450.         An example of  this would be to copy a group  of files to another
  451.         place. In  DOS, you would use the DOS  "copy" command once with a
  452.         wildcard filename  or several times with different file names. If
  453.         the files  you want to copy are not easily related by a wildcard,
  454.         then typeing the individual names  soon gets tiresome. In PFM, to
  455.         copy these files, you  can simply mark the files you  want in one
  456.         of several ways and then switch to multifile mode and hit "C" for
  457.         the copy command.
  458.  
  459.         One way of  marking files is with  the [F8] and space  key's. You
  460.         just move the cursor (pointer) to the file you want  and hit [F8]
  461.         or space. This  will put an asterisk "*" next to the file. If the
  462.         file is already marked, then [F8] will  remove the mark. This can
  463.         be used if  you have only a few files or  they are very different
  464.         in name.
  465.  
  466.         Another way  to mark  files is  with the "Include  command". This
  467.         command marks groups of files according your specification. There
  468.         is  a corresponding command to  unmark files called  the "eXclude
  469.         command". The excluding of files is especially useful if you want
  470.         to copy everything except ".BAK" files, for example. When you hit
  471.         "I" or "X" for the include or exclude commands you will be promp-
  472.         ted for your choice of the method to mark (unmark) the files.
  473.  
  474.         Following is a  list of the choices to be had with the include or
  475.         exclude commands;
  476.  
  477.     *   Every - This choice allows  you to select files very fast without
  478.         any wildcard filename prompt.
  479.     *   Before - This choice allows you  to select files before a  speci-
  480.         fied date/time. If  you select this choice,  you will be prompted
  481.         for  the date  and  time. After  entering the  time, you  will be
  482.         prompted for  a wildcard ("?"  or "*") filename  to match against
  483.         (see below).
  484.     *   After - This choice allows you to  select files after a specified
  485.         date/time in the same manner as "Before".
  486.     *   Ignore - This choice allows you to select files regardless of the
  487.         date/time or attribute. You will  be prompted for a wildcard ("?"
  488.         or "*") filename to match against (see below).
  489.     *   aTtribute - This  choice allows you to  select files depending on
  490.         attributes. You will be prompted with:
  491.  
  492.                         B= W= S= H=
  493.  
  494.         A "=" indicates that the particular attribute does not matter.
  495.         A "+" requires that a file have an attribute to be selected.
  496.         A "-" requires that a file NOT have an attribute to be selected.
  497.  
  498.         After entering the attribute  selection, you will be prompted for
  499.         a wildcard ("?" or "*") filename to match against (see below).
  500.  
  501.  
  502.  
  503.  
  504.  
  505. PFM Information Manual          Version 2.31                      Page  8
  506.     *   Oldmarks - This  choice reselects  any files which were  selected
  507.         before the  last multifile  operation. (The  files marked  with a
  508.         ".") Use this to do multifile operations on a group of files more
  509.         than once. For  example if you want  to copy a group  of files to
  510.         another place and  then delete them from  the original place, use
  511.         "I",  "O" for include oldmarks to remark the files for the delete
  512.         operation.
  513.  
  514.         When you  are  prompted  for the  wildcard filename,  you  should
  515.         follow the  standard MSDOS wildcard name conventions. If you want
  516.         all files with  the previously specified attribute,  for example,
  517.         use "*.*" for  the wildcard. PFM saves  the last several wildcard
  518.         filenames that you have  used. To reuse them, hit the  up or down
  519.         arrow keys to find the one you want, and hit return.
  520.  
  521.  
  522. MULTIFILE COMMANDS
  523. -------------------------------------------------------------------------
  524.  
  525.         The following  commands operate on  files which  have been marked
  526.         with  the "include"  flag (an "*" in  the 1st column  next to the
  527.         file entry). All of the files  are done in the same operation. If
  528.         you wish to abort the operation, hit any key on the keboard.
  529.  
  530.     *   Copy - Copy  a group of  marked files to  a new  destination. The
  531.         destination filename MUST  be an incompletely specified  or wild-
  532.         card type name  for reasonable operation. If  not, then you would
  533.         end up  copying several  files to  the same place,  writeing over
  534.         each other.
  535.     *   Delete -  Delete a group of marked files.  You must answer "Y" to
  536.         the "Are You Sure" prompt.
  537.     *   Attribute - Change  the file attributes of  the marked files. The
  538.         Backup,  Write-protect, System and Hidden attributes may be chan-
  539.         ged. To add an  attribute, use a "+", to remove  an attribute use
  540.         "-", use an "=" to leave it alone.
  541.     *   Time -  Change date and time of  the marked files. If  one of the
  542.         marked files  doesn't have the  Backup attribute set,  it will be
  543.         done by PFM.
  544.     *   cOmmand - Allows  execution of DOS commands  on the marked files.
  545.         Use the F1 and F2 keys to indicate insertion of the filename into
  546.         your command. Do not change the current directory or default disk
  547.         within your  command without  restoring it  or PFM will  get very
  548.         confused.
  549.     *   Print  - Print  the marked  files.  The "lines  per  page" prompt
  550.         allows  you to  specify a page size  for files which  do not have
  551.         form feeds imbedded. If your file is already paged, specify "0".
  552.     *   Rename - Change the  name on the marked files  to that specified.
  553.         The new filename MUST be a wildcard type name or  a new directory
  554.         on the same disk.
  555.     *   Your command - Like "cOmmand" above, except uses your preconfigu-
  556.         red commands.
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568. PFM Information Manual          Version 2.31                      Page  9
  569. MORE MENU
  570. -------------------------------------------------------------------------
  571.  
  572.         These commands are accessed by hitting "M" on the main menu. They
  573.         are generally not related to the directory being shown.
  574.  
  575.     *   Show  - This  command allows  selection of  a new  directory path
  576.         and/or drive  to display. You will  be prompted for  the new path
  577.         which does not require a  trailing "\". The last several directo-
  578.         ries that you have used are available with the cursor up and down
  579.         keys.
  580.     *   Config PFM  - This command allows you to  setup PFM with your own
  581.         system configuration. The editor PFM  uses can be changed and you
  582.         can also  configure some of  your own commands  through here. See
  583.         the  section on  'YOUR COMMANDS'  for more  information  on their
  584.         configuration. PFM also  saves many of  the "text"  entries which
  585.         you type while  using PFM (such as  old commands, copy destinati-
  586.         ons, show file search  strings, etc.) You  may want to check  and
  587.         clean up some of these  before answering 'Y' to the "OK" question
  588.         at the end of the config process.  The final configuration can be
  589.         saved on disk (in the PFM.COM file itself).
  590.     *   Edit - This command  allows you to edit a file  that you specify.
  591.         Enter the file  name in response to  the `Pathname:' prompt. This
  592.         is useful  for creating new text  files with your  editor. If you
  593.         specify a file  on another  drive or  path, PFM  changes to  that
  594.         directory before starting the editor. This means  the editor does
  595.         not require an understanding of pathnames.
  596.     *   MKDIR - This  command allows the creation  of a new subdirectory.
  597.         The path  should not be  terminated by a  "\". The new  directory
  598.         will be displayed.
  599.  
  600.  
  601. SORTING
  602. -------------------------------------------------------------------------
  603.  
  604.         The sort command  [F6] is used to  sort the directory  listing in
  605.         some useful  order. Unless  the directory  is left unsorted,  any
  606.         subdirectories present  in a directory  are placed at  the top of
  607.         the  display and  any files that are  marked to be  included in a
  608.         multi-file  operation are placed next. Beyond that, the following
  609.         orders are provided:
  610.  
  611.     *   Name - The  directory listing  is sorted  in alpha-numeric  order
  612.         with the filename  given first priority. That  is, all files with
  613.         the same first name will be together.
  614.     *   Extension  - The directory list  is sorted in alpha-numeric order
  615.         with the file extension given first priority. That is, all of the
  616.         files with the same extension will be together.
  617.     *   Size -  The directory  list is sorted  in reverse  order of  file
  618.         size. The largest  files will appear  closest to the  top of  the
  619.         listing.
  620.     *   Time - The directory list is  sorted in reverse order of the file
  621.         date and time. The newest files will appear closest to the top of
  622.         the listing.
  623.     *   Don't  sort - Files  are left in their  unsorted order (the order
  624.         that they are on the disk.)  Since PFM default is to sort  files,
  625.         you  must use  [F5] to reread the  directory in order  to see the
  626.         files  in the  original order  after you  first select  this sort
  627.         method.
  628.     *   '+' and  '-' -  You can put  a '-'  in front  of an other  key to
  629.         reverse the order. To get back to normal hit the '+' key.
  630.  
  631. PFM Information Manual          Version 2.31                      Page 10
  632. SHOW FILE
  633. -------------------------------------------------------------------------
  634.  
  635.         The show file  portion of  PFM is  one of it's  best features  (I
  636.         think)  in  that you  can show  any file,  regardless of  size or
  637.         content. Many files, particularly binary or executable ones, will
  638.         appear  as so much garbage with  this utility, but even then, you
  639.         can still see some interesting things.
  640.  
  641.         Following are a list of the commands available from the Show file
  642.         menu:
  643.  
  644.     *   Quit - This  command ends Show File  and returns to the  PFM main
  645.         menu.
  646.     *   +n / -n lines - This  command allows you to move forward  / back-
  647.         ward through the  file by the number  of lines that you  specify.
  648.         Simply press the  + or - key  and enter the number  that you want
  649.         followed by a return.
  650.     *   Variable lines  - This  command displays  the file in  text mode,
  651.         that is,  CR, LF, and TAB are interpreted in the usual manner. If
  652.         you select this mode, PFM will show all subsequent  files in this
  653.         mode. Variable lines is the default mode.
  654.     *   Fixed lines -  This command displays  the file 80 chars  per line
  655.         ignoring the meaning of the  characters. Use this mode to display
  656.         binary data files  or files without any  carriage returns. If you
  657.         select  this mode,  PFM will  show all  subsequent files  in this
  658.         mode.
  659.     *   Color -  This command  allows you  to change the  color in  which
  660.         files  are displayed. Once you select  a color, PFM will show all
  661.         subse quent files in that  color. The three available colors are:
  662.         full color whit highlight on eight bit set, only text is colored,
  663.         no color's.
  664.     *   Showmode  - This command  allows you to change  the way files are
  665.         displayed. Once you  select a mode, PFM  will show all subsequent
  666.         files in the mode. Toggles between  7 bit ASCII and 8 bit  IBM-PC
  667.         codes.
  668.  
  669.  
  670. SHOW FILE SPECIAL KEYS
  671. -------------------------------------------------------------------------
  672.  
  673.     *   ESC - Ends Show File and returns to the PFM main menu.
  674.     *   Home - Shows the file starting at the beginning.
  675.     *   End - Shows the end of the file.
  676.     *   Down arrow - Moves the cursor down one line.
  677.     *   Up arrow - Moves the cursor up one line.
  678.     *   Right arrow - Moves to the right by 8 columns to see long lines.
  679.     *   Left arrow - Moves to the left by 8 columns.
  680.     *   Ctrl-Right arrow - Moves to the right by 40 columns.
  681.     *   Ctrl-Left arrow - Moves to the left by 40 columns.
  682.     *   Pg Dn - Moves forward through the file by 20 lines.
  683.     *   Pg Up - Moves backward through the file by 20 lines.
  684.  
  685.     *   F1 - Help
  686.     *   F2 -  Search for a string  in the file. You will  be prompted for
  687.         the search string (a space matches tab or space). The cursor will
  688.         stop on the line containing the string or the end of  the file if
  689.         not found.
  690.     *   F4  - Search for the  last entered search string  again. This can
  691.         even be used to find a string in more than one file.
  692.  
  693.  
  694. PFM Information Manual          Version 2.31                      Page 11
  695. CONFIGURING
  696. -------------------------------------------------------------------------
  697.  
  698.         Note that the cursor, [Ins], and [Del] keys work for changing the
  699.         response.  You can  change the  some  default's from  PFM  in the
  700.         Configuration menu from PFM. PFM will then ask you if you require
  701.         help,  if you  enter "Y"  a  help screen  will appear  which will
  702.         remind you how to answer the following installation questions.
  703.  
  704.         After the HELP question  is complete, PFM asks the name  of the a
  705.         text editor that you generally use.
  706.  
  707.         The  requirements for  the editor  are that  it  be started  as a
  708.         ".COM" or ".EXE" file,  it must accept the file to be edited as a
  709.         command line input, and it must be able to locate  it's own over-
  710.         lays and help  files (if any)  when they are  not on  the current
  711.         disk or in the current directory. The DOS editor EDLIN.COM can be
  712.         used but there are many better ones available (such as PE).
  713.  
  714.         (Sadly WORDSTAR and PALANTIR versions that the author is familiar
  715.         with will not work.)
  716.  
  717.         Enter the  name and location of your editor as the example shows.
  718.         Remember to type the entire pathname including drive.
  719.  
  720.         Example:        Editor pathname: C:\DOS\EDLIN.COM
  721.  
  722.         This entry specifies the editor used by PFM when you want to edit
  723.         a file.
  724.  
  725.         The next question PFM asks is whether you want to keep the origi-
  726.         nal cursor provided by DOS when you return to DOS later on. Since
  727.         I happen  to like a large blinking cursor  (the better to find it
  728.         on the screen) I made this  option available. Enter a "Y" to this
  729.         question to make the cursor that way when leaving PFM.
  730.  
  731.         Example:        Keep original cursor on exit [Y/N]? Y
  732.  
  733.         Now PFM  asks you  whether you  want to  keep the  PFM main  menu
  734.         remaining when exit  PFM. This kan by  useful if you want  to see
  735.         disksize, or filespec's.
  736.  
  737.         Example:        Clear screen on exit [Y/N]? N
  738.  
  739.         The next question PFM asks refers to the setup of your own speci-
  740.         al commands.  This is  described in  detail in the  section 'YOUR
  741.         COMMANDS'. For now, just hit the "ESC" key.
  742.  
  743.         Example:        ESC or Your command Char?  [ESC]
  744.  
  745.         The next question PFM asks is if  you want to save the new confi-
  746.         guration. The answers to  all these questions and  other settings
  747.         will be  saved with PFM  if you  answer "Y". If you  don't answer
  748.         "Y", then the  answers will only  last until  you quit. (You  can
  749.         come back and change your mind later before you quit).
  750.  
  751.         Example:        Save new config [Y/N]? Y
  752.  
  753.         After all PFM will display the advertisement screen. Hit [ESC] to
  754.         return to the PFM menu screen.
  755.  
  756.  
  757. PFM Information Manual          Version 2.31                      Page 12
  758. YOUR COMMANDS
  759. -------------------------------------------------------------------------
  760.  
  761.         PFM allows the user to configure  a set of commonly used one line
  762.         commands as part of itself so that lazy typists (like me) can use
  763.         a two character sequence instead  of a longer command line entry.
  764.         To use one  of these sequences, hit  "Y" from the main  menu. The
  765.         available commands will be displayed  along the right side of the
  766.         screen preceded by their command characters. To select one,  just
  767.         hit the appropriate command character.
  768.  
  769.         To set up or change your own "Y" commands, use the "M", "C" (More
  770.         Configure) commands from the main menu to get to the configurati-
  771.         on  screen. Skip  through the  question on  your editor  with the
  772.         return  key, and  answer the  question  on the  cursor.  When the
  773.         following line prompts, enter  a command character which  will go
  774.         with the "Y":
  775.  
  776.                         ESC or Your command Char?
  777.  
  778.         If you  do not  want to enter  or change  your own  commands, hit
  779.         [ESC]. Otherwise you  will then be prompted for the  text of your
  780.         command. Enter as you would  on the usual command line, including
  781.         the [F1] to [F4] keys. Delete everything on the line  if you want
  782.         to  remove an  old command.  When you  are finished  entering the
  783.         command hit  return. If you  have more commands  to enter, repeat
  784.         the process. When you are done, you will be prompted  with an "OK
  785.         (Y/N)?".  Your configured commands  and other  changable settings
  786.         will be saved with PFM if you answer "Y" to the OK? at the end of
  787.         the configuration. If you don't answer "Y", then the new settings
  788.         will only last until you quit.
  789.  
  790.  
  791. DOS/YOUR COMMAND
  792. -------------------------------------------------------------------------
  793.  
  794.         When entering a  command string, you can  specify portions of the
  795.         current (pointed to)  pathname by entering on  of the keys F1  to
  796.         F4.  Use the F1 key for the  first part of a filename, and the F2
  797.         key for the entire file name.  If you want to include the current
  798.         path or drive in the command  string, use the F3 and/or F4  keys.
  799.         The  F5 key  is used to refer  to the "SWAP"  directory path (the
  800.         last directory  you looked at with  the F7 key). Entering  the F6
  801.         key at  the end of the command string will cause no message: "Hit
  802.         a  key to continue"  before returning to  PFM. When you  do this,
  803.         strange characters will be entered on the command line which will
  804.         later be replaced by their corresponding pathname parts.
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820. PFM Information Manual          Version 2.31                      Page 13
  821.         When you complete  the command, PFM  will execute it just  as DOS
  822.         would. When the  command is finished running,  a message "Hit any
  823.         key to continue" will  appear. When you strike a  key, the system
  824.         will return  to PFM. In  the following examples  the current dri-
  825.         ve/directory is "C:\EXAM", the  file name is "TEST.ASM", and  the
  826.         swap directory is "a:\xxx\";
  827.  
  828.             Input               Result
  829.             -----------         ---------------------------------
  830.             type [F4][F3][F2]   "type C:\EXAM\TEST.ASM"
  831.             masm [F1],[F1];     "masm TEST,TEST;"
  832.             comp [F5][F2] [F2]  "comp A:\XXX\TEST.ASM TEST.ASM"
  833.             del DEMO\[F2]       "del C:\EXAM\DEMO\TEST.ASM"
  834.             [F1]                executing the command "TEST"
  835.             xtalk               executing the command "xtalk"
  836.  
  837.         The command line also has the ability to remember the last sever-
  838.         al commands that you have used. To look at and use  them, use the
  839.         cursor down arrow and/or up arrow to find the one you want.
  840.  
  841.  
  842. DESTINATION PATH INPUT
  843. -------------------------------------------------------------------------
  844.  
  845.         When PFM prompts you for a "destination", several special options
  846.         are  available.  The  prompt  may  be  answered  with  a complete
  847.         pathname (drive, path,  file, ext) or just  some of these. If  an
  848.         element is  missing, then  PFM will  assume the current  pathname
  849.         component for  the missing  element. You  can also  use wildcards
  850.         ("?" or "*") as DOS does  in the file or extension portion of the
  851.         pathname. PFM behaves much like  DOS in all these examples. Also,
  852.         PFM allows you to use the  full pathname of the last referred  to
  853.         "SWAP" directory (see  [F7] key). This option  is used by hitting
  854.         the [F5] key in place of a drive and path. PFM will then  automa-
  855.         tically  replace the funny character (Club)  with the pathname of
  856.         the swap directory.
  857.  
  858.         In the  following examples  the cursor is  in front  of the  file
  859.         "test.123" in the single-file main menu. The current drive/direc-
  860.         tory is "C:\EXAM".
  861.  
  862.             Input       Destination
  863.             ----------- -----------------------------------------
  864.             a:          A:\DATA\test.123  if last dir accessed  on A: was
  865.                         "DATA"
  866.             a:\         A:\test.123)
  867.             \ouch       C:\ouch  if  C:  does not  contain  a  dir called
  868.                         "OUCH")
  869.             \ouch       C:\OUCH\test.123 if C: does contain  a dir called
  870.                         "OUCH")
  871.             \ouch\      C:\OUCH\test.123
  872.             a:\*.       A:\test
  873.             a:\*.xyz    A:\test.xyz
  874.             a:\*        A:\test.123
  875.             ?z*.?4?     C:\EXAM\tzst.143
  876.             *.*         C:\EXAM\test.123 (an error)
  877.             [F5]        A:\test.123 if  the last accessed  swap directory
  878.                         was a:\
  879.  
  880.  
  881.  
  882.  
  883. PFM Information Manual          Version 2.31                      Page 14
  884.         Note:   Since copying  a file to  itself would erase  most of the
  885.                 file, PFM considers  this an error and  does it's best to
  886.                 prevent this occurrence.
  887.  
  888.         When the  destination has  been  fully specified,  a return  will
  889.         cause the  operation to be  performed. The  destination file name
  890.         will be  displayed on  the second  line of  the screen the  first
  891.         letter of  the command  will appear where  the cursor was  in the
  892.         main part of the screen. If an error occurs it  will be displayed
  893.         at the top of the screen. PFM saves the last several destinations
  894.         for you. To use them, hit the up-arrow and/or down-arrow keys  to
  895.         find the one you want.
  896.  
  897.  
  898. LINE EDITING
  899. -------------------------------------------------------------------------
  900.  
  901.         Whenever PFM prompts you for  a response which requires more than
  902.         a single character, it  allows you to use the keys  on the cursor
  903.         pad and some others to help you change the line you are entering.
  904.         The entry fields are generally  long enough for their normal use,
  905.         but if you try to go beyond the end, the cursor will refuse to do
  906.         it. Following are the keys and what they do:
  907.  
  908.     Right     - move the cursor  to the right nondestructively  until the
  909.                 end of the current entry is reached.
  910.     Ctrl Right- move the cursor  to the next "word"  to the right or  the
  911.                 end of the line if this is the last word.
  912.     Left      - move  the cursor to  the left nondestructively  until the
  913.                 beginning of the entry is reached.
  914.     Ctrl Left - move the cursor to the  beginning of the previous word or
  915.                 the beginning of the entry if appropriate.
  916.     Backspace - delete the character to the left of the cursor.
  917.     Del       - delete the character under the cursor.
  918.     Ins       - go into insert mode until a special character is entered.
  919.                 Characters are inserted before the current cursor locati-
  920.                 on.
  921.     Home      - move the cursor to the beginning of the entry.
  922.     End       - move the cursor to the end of the entry.
  923.     Shift Tab - move the cursor to the beginning of the entry.
  924.     Tab       - move the cursor to the end of the entry.
  925.     Ctrl End  - delete from the cursor to the end of the line.
  926.     Ctrl Ret  - delete from the cursor to the end of the line and return.
  927.     Return    - take the current entry as it is. (return does not need to
  928.                 be at the end of the line).
  929.     Esc       - Ignore the current entry and exit from command.
  930.     Up        - For  those  prompts which  "remember"  your  last several
  931.                 entries, this goes through them in order of age.
  932.     Down      - Like  the Up  arrow above, except  that your  next newest
  933.                 entry is displayed.
  934.     Ctrl Home - For  those prompts  which  "remember" your  last  several
  935.                 entries, this will  remove all of the  remembered entries
  936.                 (usually used before configuring to "clean house").
  937.  
  938.         The keys [F1] to [F6] will put special characters into the  entry
  939.         which will only be meaningful in "cOmmands". At other times, they
  940.         may cause strange errors. Other special keys will be ignored.
  941.  
  942.  
  943.  
  944.  
  945.  
  946. PFM Information Manual          Version 2.31                      Page 15
  947. ERRORS
  948. -------------------------------------------------------------------------
  949.  
  950.         PFM tries to make error handling as easy as possible. If an error
  951.         occurrs during normal  operation which DOS would  let you fix and
  952.         retry, PFM also  lets you fix and retry or abort. If the error is
  953.         such  that a retry is not  reasonable, an error code is displayed
  954.         and you are given a chance to look at the error help list or just
  955.         to  return to  the menu. Following is  a list of  the error codes
  956.         that you  might get and what they  might mean. If you  get a code
  957.         that is not in the list, then try looking up the code in your DOS
  958.         manual (you may have a different DOS than I do).
  959.  
  960.    1 -  DOS  function  number  invalid.  This  shouldn't  happen, contact
  961.         program support.
  962.    2 -  File not  found. The disk has been changed  or perhaps the editor
  963.         is not present where it was configured to be.
  964.    3 -  Path  not found. Possibly  invalid syntax, remember,  no trailing
  965.         "\" on "More MKDIR" command.
  966.    4 -  Too many files open, no handles available. See your DOS manual on
  967.         system configuration. (CONFIG.SYS)
  968.    5 -  Access denied or protection violation. This usually means you are
  969.         trying  to write  or  delete  a "write-protected"  file. Use  the
  970.         "Attribute" command to unprotect the file.
  971.    6 -  Invalid  file handle.  This  shouldn't  happen,  contact  program
  972.         support.
  973.    7 -  Memory  control block destroyed.  Something has gone  very wrong,
  974.         you had better reboot.
  975.    8 -  Insufficient memory  for program. The  program might  work if you
  976.         "Quit" PFM first to open up  some more memory and then run in the
  977.         old fashioned DOS way.
  978.    10 - Invalid environment, usually  >32K in length. Something  has gone
  979.         very wrong, you had better reboot.
  980.    11 - DOS error, Invalid format. Who Knows???
  981.    12 - DOS error, Invalid Access code. Who Knows???
  982.    13 - DOS error, Invalid Data. Who Knows???
  983.    15 - Invalid  drive number specified.  You probably specified  a drive
  984.         letter higher than you should have.
  985.    16 - Cannot remove the current directory. If you really want to, first
  986.         delete all the files and other directories in it first.
  987.    17 - Cannot rename from one device to another. The only way to do this
  988.         is to copy to the other device and then delete the original.
  989.    18 - No more files available in the directory. That just about says it
  990.         all.
  991.    19 - No more room on the disk. That just about says it all.
  992.    21 - Incorrect  syntax in operator entry.  PFM doesn't like the syntax
  993.         of the Date/time entry or maybe of an attribute spec.
  994.    22 - Cannot copy a file to  itself. Since this would generally destroy
  995.         the file, PFM will not let you do this.
  996.    23 - Cannot show an empty file.
  997.    24 - Cannot  load a  permanent  memory resident  task  from  PFM. Some
  998.         programs (like PFM)  leave parts of themselves  in memory all the
  999.         time after they are loaded. An example  is the DOS PRINT utility.
  1000.         Since PFM  uses memory in a  simple minded way, programs  such as
  1001.         these can  not be run  from PFM. Sometimes  programs such  as the
  1002.         PRINT utility  can be loaded once before starting PFM (like in an
  1003.         AUTOEXEC.BAT)  and will  then run  normally  when called  by  PFM
  1004.         afterwords.
  1005.  
  1006.  
  1007.  
  1008.  
  1009. PFM Information Manual          Version 2.31                      Page 16